26:
58:
373:
79:
329:
286:
316:
823:
This is a multifunction template. At its simplest, it adds the currency mark "US$ ", as recommended by MOS:CURRENCY for many situations. The template can also link to the United States dollar article and can even calculate
999:
If no, display of "US" before the "$ " sign will be suppressed when it is clear from context that the United States dollar is meant, rather than one of the twenty or so other currencies going by the name of
655:
can reduce the impact somewhat. If you call this template from within another template and use the inflation feature, consider adding a caution similar to this one to that template's documention page.
548:
will cause the template to calculate to the nearest dollar (instead of the nearest cent), and prefix the calculated value with "about". The rounding can be fine-tuned further by using
399:), the equivalent value represented in 2023 dollars will be calculated in parentheses. However, this function should only be used in appropriate situations.
65:
722:
648:
148:
Additional text like "million" or "trillion" must be placed outside the template, typically preceded by a non-breaking space (see example below).
1087:
889:
Specify a year and, if this year is between 1800 and the current year minus 1, the inflation-adjusted value will be calculated in parentheses
389:. If the second parameter is used, to specify a year, and this year is within a certain range of available inflation data (specifically,
295:
of inflating
Consumer Price Index values: staples, workers' rent, small service bills (doctor's costs, train tickets). This template is
1126:
1136:
1098:
299:
of inflating capital expenses, government expenses, or the personal wealth and expenditure of the rich; for such purposes refer to
311:. If you are not sure and do not have economic training yourself, then please consult someone who does before using this template.
1083:
1071:
41:
732:
1110:
1067:
37:
1141:
1053:
86:
970:
Integer, where round to number of decimal points specified, use negative (for example, -2) for significant figures
941:
If yes, calculate to the nearest dollar (instead of the nearest cent) and prefix the calculated value with "about"
806:
204:. This is turned off by default, but may be appropriate for the first occurrence of the term in an article.
798:
1131:
45:
112:
This is a multifunction template. At its simplest, it adds the currency mark "US$ ", as recommended by
643:
777:
1093:
359:
95:
235:, display of "US" before the "$ " sign may be suppressed when it is clear from context that the
802:
794:
99:
1078:
91:
490:
268:
236:
218:
201:
117:
8:
672:
between the amount and the inflation convertion. This is used for sentence structuring.
384:
302:
103:
647:
in the software that makes
Knowledge work. Pages that exceed this limit are placed in
1106:
1061:
1057:
727:
239:
is meant, rather than one of the twenty or so other currencies going by the name of "
33:
66:
Template talk:Currency#Suggestions for a standard set of options for each template
762:
1120:
757:
626:{{US$ |1000|1935|round=-2|about=yes}}
641:
The inflation-calculation code causes this template to approach the 40-deep
335:
Do not assume that using this template will mean that a calculated value is
57:
782:
772:
767:
752:
747:
742:
737:
710:
365:
113:
20:
372:
1029:
If yes, show 'in YYYY' between the amount and the inflation calculation
263:{{US$ |123.45|long=no|link=yes}}
90:
and changes may be widely noticed. Test changes in the template's
693:{{US$ |100|1850|showyear=yes}}
309:
Incorrect use of this template would constitute original research
315:
240:
614:{{US$ |1000|1935|round=-2}}
602:{{US$ |1000|1935|round=2}}
590:{{US$ |10|1935|about=yes}}
485:{{US$ |100|1966|link=yes}}
578:{{US$ |10|1935|round=0}}
723:
Knowledge:Manual of Style (dates and numbers)#Currencies
381:
The template supports inflation calculation, by way of
116:
for many situations. The template can also link to the
834:
This template prefers inline formatting of parameters.
213:{{US$ |123.45|link=yes}}
252:{{US$ |123.45|long=no}}
700: in 1850 (equivalent to $ 3,662 in 2023)
1118:
649:Category:Pages where expansion depth is exceeded
681:{{US$ |100|1850}}
534:{{US$ |100|2025}}
523:{{US$ |100|2024}}
512:{{US$ |100|2023}}
500:{{US$ |100|2022}}
473:{{US$ |100|1966}}
461:{{US$ |100|1634}}
450:{{US$ |100|1633}}
566:{{US$ |10|1935}}
813:in articles based on its TemplateData.
633: (equivalent to about $ 22,200 in 2023)
1077:Editors can experiment in this template's
226:
123:
120:article and can even calculate inflation.
23:
597: (equivalent to about $ 222 in 2023)
276:
200:may be used to link US$ to the article
168:{{US$ |123.45}}
609: (equivalent to $ 22,223.3 in 2023)
1119:
356:to refer to calculated value, instead
621: (equivalent to $ 22,200 in 2023)
573: (equivalent to $ 222.23 in 2023)
507: (equivalent to $ 104.12 in 2023)
495: (equivalent to $ 939.08 in 2023)
480: (equivalent to $ 939.08 in 2023)
102:. Consider discussing changes on the
807:See a monthly parameter usage report
688: (equivalent to $ 3,662 in 2023)
555:. These parameters may be combined.
468: (equivalent to $ 1,019 in 2023)
323:
280:
73:
733:Knowledge:Wikiproject United States
13:
585: (equivalent to $ 222 in 2023)
14:
1153:
1043:
1014:
984:
955:
926:
897:
874:
704:
1127:United States economic templates
788:
371:
327:
314:
284:
77:
56:
24:
1137:Currencies of the United States
87:approximately 12,000 pages
1:
659:
157:{{US$ }}
124:§ Inflation calculation
7:
716:
437:|about=yes}}
178:{{US$ |123}}{{nbsp}}million
10:
1158:
1051:
797:for this template used by
1111:Subpages of this template
840:
106:before implementing them.
98:subpages, or in your own
85:This template is used on
1142:Unit indicator templates
778:Template:Philippine peso
130:
191:
1105:Add categories to the
666:|showyear=yes
364:may be used. See also
122:See warnings below in
61:Relevant discussion at
29:Template documentation
816:TemplateData for US$
644:expansion depth limit
544:Additional parameter
277:Inflation calculation
912:Link US$ to article
668:may be used to show
362:|US}}
348:or even necessarily
237:United States dollar
202:United States dollar
118:United States dollar
1049:
837:
830:Template parameters
653:|about=yes
546:|about=yes
1132:Currency templates
828:
826:
820:
339:
310:
298:
294:
198:|link=yes
1062:Template:US$ /doc
1048:
1047:
853:
821:
805:and other tools.
728:Template:Currency
379:
378:
334:
322:
321:
308:
296:
292:
291:This template is
233:|long=no
110:
109:
71:
70:
1149:
1102:
1091:
1075:
1025:
995:
966:
937:
908:
885:
862:
854:
838:
835:
827:
699:
695:
694:
687:
683:
682:
671:
667:
654:
632:
628:
627:
620:
616:
615:
608:
604:
603:
596:
592:
591:
584:
580:
579:
572:
568:
567:
554:
550:|round=
547:
540:
536:
535:
529:
525:
524:
518:
514:
513:
506:
502:
501:
494:
487:
486:
479:
475:
474:
467:
463:
462:
456:
452:
451:
438:
417:
415:
411:
398:
396:
388:
375:
363:
355:
331:
330:
324:
318:
306:
288:
287:
281:
272:
265:
264:
258:
254:
253:
234:
222:
215:
214:
199:
186:
183:
179:
174:
170:
169:
163:
159:
158:
145:
143:
81:
80:
74:
60:
53:
52:
49:
30:
28:
27:
18:
1157:
1156:
1152:
1151:
1150:
1148:
1147:
1146:
1117:
1116:
1115:
1114:
1104:
1096:
1081:
1076:
1065:
1050:
1023:
993:
964:
935:
906:
883:
860:
833:
819:
791:
719:
707:
697:
692:
691:
685:
680:
679:
669:
665:
662:
652:
630:
625:
624:
618:
613:
612:
606:
601:
600:
594:
589:
588:
582:
577:
576:
570:
565:
564:
553:
549:
545:
538:
533:
532:
527:
522:
521:
516:
511:
510:
504:
499:
498:
489:
484:
483:
477:
472:
471:
465:
460:
459:
454:
449:
448:
436:
432:
428:
420:
413:
409:
403:
395:
392:
390:
382:
357:
354:{{CURRENTYEAR}}
353:
328:
300:
285:
279:
267:
262:
261:
256:
251:
250:
232:
229:
217:
212:
211:
197:
194:
184:
181:
177:
172:
167:
166:
161:
156:
155:
141:
135:
133:
78:
72:
50:
31:
25:
16:
12:
11:
5:
1155:
1145:
1144:
1139:
1134:
1129:
1046:
1045:
1042:
1039:
1038:
1037:
1034:
1026:
1021:
1017:
1016:
1013:
1010:
1009:
1008:
1005:
996:
991:
987:
986:
983:
980:
979:
978:
975:
967:
962:
961:Decimal points
958:
957:
954:
951:
950:
949:
946:
938:
933:
929:
928:
925:
922:
921:
920:
917:
909:
904:
900:
899:
896:
893:
892:
886:
881:
877:
876:
873:
870:
869:
866:Amount in US$
863:
858:
852:
851:
848:
845:
842:
799:TemplateWizard
792:
790:
787:
786:
785:
780:
775:
770:
765:
760:
755:
750:
745:
740:
735:
730:
725:
718:
715:
714:
713:
706:
705:Redirects here
703:
702:
701:
689:
664:The parameter
661:
658:
657:
656:
639:
635:
634:
622:
610:
598:
586:
574:
551:
542:
541:
530:
519:
508:
496:
481:
469:
457:
440:
439:
434:
430:
426:
418:
393:
377:
376:
369:
360:Inflation/year
351:
347:
343:
338:
332:
320:
319:
312:
289:
278:
275:
274:
273:
259:
231:By specifying
228:
225:
224:
223:
196:The parameter
193:
190:
189:
188:
175:
164:
132:
129:
127:
108:
107:
82:
69:
68:
62:
51:
22:
21:
9:
6:
4:
3:
2:
1154:
1143:
1140:
1138:
1135:
1133:
1130:
1128:
1125:
1124:
1122:
1112:
1108:
1100:
1095:
1089:
1085:
1080:
1073:
1069:
1063:
1059:
1055:
1054:documentation
1040:
1035:
1032:
1031:
1030:
1027:
1022:
1019:
1018:
1011:
1006:
1003:
1002:
1001:
997:
992:
989:
988:
981:
976:
973:
972:
971:
968:
963:
960:
959:
952:
947:
944:
943:
942:
939:
934:
931:
930:
923:
918:
915:
914:
913:
910:
905:
902:
901:
894:
891:
890:
887:
882:
879:
878:
871:
868:
867:
864:
859:
856:
855:
849:
846:
843:
839:
836:
831:
825:
818:
817:
812:
811:Template:US$
808:
804:
800:
796:
789:Template data
784:
781:
779:
776:
774:
771:
769:
766:
764:
761:
759:
758:Template:Euro
756:
754:
751:
749:
746:
744:
741:
739:
736:
734:
731:
729:
726:
724:
721:
720:
712:
709:
708:
690:
678:
677:
676:
673:
650:
646:
645:
640:
637:
636:
623:
611:
599:
587:
575:
563:
562:
561:
560:
556:
531:
520:
509:
497:
492:
482:
470:
458:
447:
446:
445:
444:
424:
419:
407:
402:
401:
400:
386:
374:
370:
367:
361:
352:. Do not use
349:
345:
341:
336:
333:
326:
325:
317:
313:
304:
290:
283:
282:
270:
260:
249:
248:
247:
244:
242:
238:
227:Suppress "US"
220:
210:
209:
208:
205:
203:
176:
165:
154:
153:
152:
149:
146:
139:
128:
125:
121:
119:
115:
105:
101:
97:
93:
89:
88:
83:
76:
75:
67:
63:
59:
55:
54:
47:
43:
39:
35:
19:
1028:
998:
969:
940:
911:
888:
865:
832:
829:
822:
815:
814:
810:
803:VisualEditor
795:TemplateData
793:This is the
783:Template:PKR
773:Template:JPY
768:Template:INR
763:Template:GB£
753:Template:CNY
748:Template:CAD
743:Template:BDT
738:Template:AUD
711:Template:USD
674:
663:
642:
558:
557:
543:
442:
441:
433:|round=
422:
421:{{
416:}}
405:
404:{{
387:}}
383:{{
380:
366:MOS:REALTIME
358:{{
346:"as of 2023"
342:"as of 2024"
305:}}
301:{{
293:only capable
245:
230:
206:
195:
150:
147:
144:}}
137:
136:{{
134:
114:MOS:CURRENCY
111:
100:user subpage
84:
15:
1058:transcluded
844:Description
44:] [
40:] [
36:] [
1121:Categories
1052:The above
1020:Show year?
824:inflation.
391:if 1634 ≤
246:Examples:
173:US$ 123.45
96:/testcases
1109:subpage.
1094:testcases
1000:"dollar".
985:suggested
927:suggested
898:suggested
841:Parameter
675:Example:
660:Show year
651:. Using
631:US$ 1,000
619:US$ 1,000
607:US$ 1,000
559:Examples:
443:Examples:
397:< 2023
385:Inflation
337:"current"
303:Inflation
297:incapable
207:Example:
151:Example:
104:talk page
1044:optional
1024:showyear
1015:optional
956:optional
875:required
717:See also
350:"recent"
257:$ 123.45
92:/sandbox
1086:|
1079:sandbox
1072:history
1070:|
1041:Boolean
1033:Example
1012:Boolean
1004:Example
974:Example
953:Boolean
945:Example
924:Boolean
916:Example
698:US$ 100
686:US$ 100
670:in YYYY
638:Caution
552:integer
539:US$ 100
528:US$ 100
517:US$ 100
505:US$ 100
478:US$ 100
466:US$ 100
455:US$ 100
187:million
182:US$ 123
42:history
1103:pages.
982:Number
932:About?
895:Number
872:Number
857:Amount
850:Status
595:US$ 10
583:US$ 10
571:US$ 10
429:|
425:|
412:|
408:|
271:123.45
241:dollar
221:123.45
185:
142:number
140:|
1060:from
990:US$ ?
965:round
936:about
903:Link?
435:round
427:value
410:value
131:Usage
48:]
46:purge
32:[
1107:/doc
1099:edit
1092:and
1088:diff
1084:edit
1068:edit
994:long
907:link
880:Year
847:Type
809:for
491:US$
431:year
423:US$
414:year
406:US$
394:year
243:".
219:US$
192:Link
162:US$
138:US$
38:edit
34:view
17:US$
1056:is
1036:yes
948:yes
919:yes
493:100
94:or
1123::
1064:.
1007:no
801:,
696:→
684:→
629:→
617:→
605:→
593:→
581:→
569:→
537:→
526:→
515:→
503:→
488:→
476:→
464:→
453:→
344:,
340:,
307:.
269:$
266:→
255:→
216:→
180:→
171:→
160:→
64:→
1113:.
1101:)
1097:(
1090:)
1082:(
1074:)
1066:(
977:2
884:2
861:1
368:.
126:.
Text is available under the Creative Commons Attribution-ShareAlike License. Additional terms may apply.
